home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_2 / prodz203.zip / PRODIZ.DOC < prev    next >
Text File  |  1992-09-10  |  8KB  |  187 lines
  1.                                   ProDIZ 2.0
  2.              CopyRight 1991-92 by Max Bernard & Dave Navarro, Jr
  3.             FILE_ID.DIZ Specs CopyRight 1991 by Clark Development
  4.  
  5.  
  6.  What is ProDIZ?
  7.  ---------------
  8.  
  9.  ProDIZ is a command line utility  for  ProDoor  sysops.    It  scans  uploaded
  10.  archives using the ZIP, ARJ, and LZH format for a file named "FILE_ID.DIZ" and
  11.  extracts it  if found, using the text to  replace any description typed by the
  12.  user.
  13.  
  14.  The format  for FILE_ID.DIZ is very simple, it's  a standard text file with up
  15.  to 10 lines of description with each line a maximum of 45 charactors in width.
  16.  
  17.  ProDIZ also  optionally ads the number  of files found in  the archive and the
  18.  file  dates of the oldest and youngest members, the uncompressed archive size,
  19.  and the serial number for ZIP files that have an AV.
  20.  
  21.  Here is a sample description:
  22.  
  23.    | ProDIZ 1.9, ProDoor 3.44 utility to scan
  24.    | ZIP, LZH, and ARJ files for FILE_ID.DIZ &
  25.    | DESC.SDI and replace the caller-provided
  26.    | description if either one is found. Has
  27.    | options for adding the number of files,
  28.    | oldest/newest file dates, uncompressed
  29.    | filesize, and -AV information for ZIPs to
  30.    | the description.  WARNING!  This only works
  31.    | with ProDoor 3.44 dated 12/31/91 or later!
  32.    | FREEWARE by Dave Navarro, Jr. and Max Bernard
  33.    | Files: 6  Old: 02/22/92  New: 02/27/92 * DIZ
  34.    | Uncompressed Size: 47,811 bytes
  35.  
  36.  
  37.  How do I use ProDIZ?
  38.  --------------------
  39.  
  40.  It's pretty simple,  just pass  the filename  of the  current archive  and the
  41.  name/location of the $DOOR.NAM file created by ProDoor:
  42.  
  43.  PRODIZ %2 %PCBDRIVE%%PCBDIR%\$DOOR.NAM
  44.  
  45.  If you want it to add the file date info, add a "/D" on the end of the command
  46.  line.
  47.  
  48.  If you want it to add the uncompressed size info, add a "/U" on the end of the
  49.  command line.
  50.  
  51.  If  you want to add the AV serial number  for ZIPs if found, then add "/AV" on
  52.  the command line.
  53.  
  54.  If you want  to add a text line  of your own, you can  use the "/A:" option in
  55.  the form of:
  56.  
  57.  /A:Tested by ZipLAB 1.9b
  58.  
  59.    ** This must be the LAST option on the command line, as everything
  60.    ** following the /A: will be added to the description.
  61.  
  62.  When a user uploads a file in ProDoor, they are asked for the name of the file
  63.  being uploaded and a description.  This  is  then  written  to  a  file  named
  64.  $DOOR.NAM  which is kept in  the same directory as  PCBOARD.SYS for each node.
  65.  So,  if  node  1  is  located  in  C:\PCB,  then  you  would  put  "prodiz  %2
  66.  c:\pcb\$door.nam" in your PROUT1.BAT file.
  67.  
  68.  (See enclosed PROUT1.BAT file for more info on multiple nodes.)
  69.  
  70.  
  71.  ProDIZ command reference
  72.  ------------------------
  73.  
  74.  If you just type PRODIZ from the DOS prompt, you get the following display:
  75.  
  76.  ProDIZ 2.03 - Description Extraction Utility for ProDoor 3.44+
  77.  CopyRight (c) 1991-92 by Max Bernard & Dave Navarro, Jr
  78.  
  79.  Usage: PRODIZ ARCfile.ext BBS-Desc.fil [/Options]
  80.  
  81.   Where [options] are:
  82.       /A:text  Insert a line of text into the description
  83.                  Example: /A:This is the text
  84.       /AV      Insert ZIP -AV serial number if found
  85.       /D       Insert File Count and dates in description
  86.                  Example: Files: 5  Old: 01/01/90  New: 02/15/92
  87.       /E       Erase files that fail age test (requires /O)
  88.       /L       Run in local mode (Add DIZ/SDI to DIR file)
  89.       /O:yymm  Minimum date requirement (i.e. /O:9101 for Jan-1991)
  90.       /P       Make U/L private if no FILE_ID.DIZ or DESC.SDI found
  91.       /U       Add Uncompressed file size to description
  92.  
  93.  
  94.  Command details
  95.  ---------------
  96.  
  97.  /A:text
  98.  The /A:text switch instructs ProDIZ to add the text following /A: to the end
  99.  of the file description.  Note that, if used, this  must  be the last switch
  100.  on the ProDIZ command line.
  101.  
  102.  /AV
  103.  This instructs ProDIZ to the -AV (Authenticity Verification) stamp from ZIP
  104.  files (if found) and add it to the file description
  105.  
  106.  /D
  107.  This instructs ProDIZ to add a line at after the file description showing
  108.  the number of files in the archive, the date stamp of the oldest and the
  109.  youngest files in the archive.  See example above.
  110.  
  111.  /E
  112.  This imstructs ProDIZ to Erase (DELETE) files that fail the maximum age
  113.  requirement test as specified with the /O switch.  The /E switch has no
  114.  effect if the /O switch is not used.  (See /O switch description).
  115.  
  116.  /L
  117.  If the /L switch is present, ProDIZ modifies its operation to accept and
  118.  process a DIR type file for the file description instead of the $DOOR.NAM
  119.  file.  This is the offline mode of operation for ProDIZ.  Using this mode
  120.  you can use ProDIZ to test files (for age) and modify file descriptions
  121.  offline (from the DOS prompt) instead of from ProDoor.  For instance, you
  122.  could write a batch file to call ProDIZ for all the files in a certain di-
  123.  rectory and process them as if they had just been uploaded to your system.
  124.  
  125.  /O:yymm
  126.  This instructs ProDIZ to test the date of files inside the Archive against
  127.  the month and year specified.  If any of the files is older than the speci-
  128.  fied month  and year, ProDIZ displays a message on the screen and sets an
  129.  internal  flag for use by the /E switch.  If the /E switch is present, any
  130.  file that fails this test will be DELETED from the system.  ProDIZ returns
  131.  an ERRORLEVEL of 2 when a file fails this test.  This way you get a chance
  132.  to process those files that fail in anyway you wish (like moving them to a
  133.  holding  directory until  you've had a chance to inspect them manually and
  134.  decide  for yourself if  they are worth  keeping or not.  See the included
  135.  sample PROUT1.BAT file.
  136.  
  137.  /P
  138.  If this switch is present, ProDIZ will make the uploaded file private if
  139.  it doesn't include either a FILE_ID.DIZ or DESC.SDI embedded description.
  140.  
  141.  /U
  142.  This switch causes ProDIZ to append a line to the file description showing
  143.  the un-compressed size of the archive.  This is the amount of space that
  144.  would be required, on your hard disk, to un-archive this file.
  145.  
  146.  
  147.  How much is registration?
  148.  -------------------------
  149.  
  150.  This is a FREEWARE utility, which means that no fee is required to use it, but
  151.  I retain all rights  to the  program (including  the right  to change  my mind
  152.  later  if I so choose).  In the past,  I have written and released a number of
  153.  freeware utilities for sysops.  My only request, that if you use it, you spend
  154.  $1 on an interesting post card from your home town, and 15 cents on a stamp to
  155.  mail  it.  This isn't required, but I really would like to know what you think
  156.  of ProDIZ,  and I  enjoy seeing  postcards from  all over  the place.   Please
  157.  consider it..
  158.  
  159.  
  160.  What about support?
  161.  -------------------
  162.  
  163.  That's the  CATCH-22 with FREEWARE, since I charge  no fee, I am not obligated
  164.  to support it..  This doesn't mean that I don't support ProDIZ, just that it's
  165.  low  on my totem pole  of things to work  on..  It all  depends on the request
  166.  that I get..  If it's intrigueing enough to me, I'll do it..  If you send me a
  167.  nice  post card with your request on it, I might feel obligated enough to make
  168.  whatever change  your asking  for (hint,  hint..) However,  I will  always fix
  169.  whatever bugs people  point  out,  so  if  you  encounter  one,  let  me  know
  170.  immediately and I'll get to it.
  171.  
  172.  
  173.  So, how do I contact you?
  174.  -------------------------
  175.  
  176.  By BBS at:
  177.  
  178.      The Taste BBS in Brooklyn, NY
  179.      (718) 252-4529.
  180.  
  181.  Through US Mail at:
  182.  
  183.      ProDIZ Support
  184.      c/o Max Bernard
  185.      P.O. Box 100564
  186.      Brooklyn, NY 11210
  187.